4. Methods and Callbacks

4.05 On Link

Syntax:
On Link linkStr
End

Purpose:
This callback is provided when the user clicks on a link.

When the user clicks on a hyper link, the xtra sends a message back to Lingo, which can be handled in the On Link callback handler. This handler can be placed in a score script, cast member script, frame script or movie script, according to the priorities described in the Director manuals.

linkStr is a string parameter, which contains the link description taken from the HREF parameter of the html tag.

Notes:

• When the user clicks on a link, previously made selections are dropped.
• Due to the way, director handles callbacks from Xtras, it is not possible to "go" to another movie from inside a "on link" handler. This will lead to a crash.